@bridge-ds/core 0.23.0 → 0.24.0

package/dist/exploration-resume.d.ts

@@ -13,6 +13,24 @@ export declare function explorationStage(x: {
     archived?: boolean | null | undefined;
     files: readonly string[] | null | undefined;
 }): 'not-started' | 'exploring' | 'handed';
+/** The words of a running exploration on its page, and on every row and card that lists it. */
+export declare const EXPLORATION_STAGE_LABEL: {
+    readonly 'not-started': "Not started";
+    readonly exploring: "Exploring";
+    readonly archived: "Archived";
+};
+/**
+ * The one status tag of an exploration wherever it is listed (Changes rows, Home cards, tools): the words its page
+ * shows. Running: "Not started" while the branch only carries Bridge notes, else "Exploring". Archived: "Archived".
+ * After done exploring: where it stands ("Waiting for code", "Being built", "Shipped"). Never a check or a technical
+ * blocker: an exploration's guard check fails by design. `files` undefined (not read yet): null for a running one, so
+ * a row never guesses; null (the read failed): "Exploring", as on the page.
+ */
+export declare function explorationStateLabel(x: {
+    status: ExplorationStatus;
+    archived?: boolean | null | undefined;
+    files?: readonly string[] | null | undefined;
+}): string | null;
 export interface ContinueRef {
     number: number;
     name: string;

package/dist/explorations.d.ts

@@ -176,6 +176,27 @@ export declare function isHandedOff(p: Pick<ExplorationPullLike, 'labels' | 'bod
  * done exploring is the older promotion: promoted, open or merged.
  */
 export declare function explorationStatus(p: ExplorationPullLike): ExplorationStatus;
+/**
+ * The pull request is an exploration right now: open with the `exploration` label (archived ones keep it), or a running
+ * exploration whose label is missing (isUnlabeledExploration: an open draft on an `explore/*` branch or with the
+ * Bridge block). Its guard check (EXPLORATION_CHECK) fails by design then, so every check summary leaves that check out
+ * (review-gate summarizeCi `exploration`): Studio, the MCP server and the CLI never read it as a problem. Any other
+ * pull request with that check failing still counts it.
+ */
+export declare function isGuardedExploration(p: {
+    state?: string | undefined;
+    draft?: boolean | undefined;
+    labels?: readonly (string | {
+        name?: string;
+    })[] | null | undefined;
+    headRef?: string | null | undefined;
+    head?: {
+        ref?: string | null | undefined;
+    } | null | undefined;
+    body?: string | null | undefined;
+}): boolean;
+/** True for the guard check of an exploration (EXPLORATION_CHECK), by check run name or status context. */
+export declare const isExplorationCheck: (name: string | null | undefined) => boolean;
 /** True while the label is on: the pull request must not merge (the CI check fails, Studio blocks the merge). */
 export declare const isActiveExploration: (labels: ExplorationPullLike["labels"]) => boolean;
 /** True for an archived exploration: hidden from the default lists, reachable from the Archived filter. */

package/dist/github-client.d.ts

@@ -605,8 +605,13 @@ export declare class GitHubClient {
     /** Every file path at a ref (branch, tag or sha), one API call. */
     listFiles(ref: string): Promise<string[]>;
     listPullRequests(state?: 'open' | 'closed' | 'all'): Promise<PullRequestSummary[]>;
-    /** Commit statuses and check runs of a commit, folded into one state. */
-    getChecks(sha: string): Promise<{
+    /**
+     * Commit statuses and check runs of a commit, folded into one state. `exploration`: the commit heads an exploration
+     * (explorations isGuardedExploration), so its guard check, failing by design, is left out (as review-gate summarizeCi).
+     */
+    getChecks(sha: string, opts?: {
+        exploration?: boolean | undefined;
+    }): Promise<{
         state: 'success' | 'failure' | 'pending' | 'none';
         checks: {
             name: string;